
##########################################################################
#
#		INSTALLING KAOS
#
##########################################################################
	SETTING KAOS ENVIRONMENTAL VARIABLES
#########################################################################

	In order to install and run "kaos", you need to insert a few lines
	into the files ".login" and ".cshrc" in your home directory.

(1)	Include the environmental variable "KAOSHOME",
	which is the top directory where kaos is currently installed.
	(Ask the system manager or try to locate where the executable "kaos"
	is in the system file hierarchy.)

	For example, insert a line such as

		setenv KAOSHOME ${HOME}/kaos

(2)	Add the directories, ${KAOSHOME} and ${KAOSHOME}/bin,
	to the search path. This ensures that you can run the program
	kaos and its companion programs in any directory and make
	future installation work.
	For example, a line in .login and .cshrc should look like

		set path = (${KAOSHOME} ${KAOSHOME}/bin other_directories...)

########################################################################
	USING KAOS_INSTALL
########################################################################

	Use the shell script "kaos_install"  to set various flags
	such as the top directory, the operating system type, 
	the printer name, the math flag, and the floating point coprocessor type

  (1)	Make sure first that ${KAOSHOME} environmental variable is set
	as instructed in the previous section.

  (2)	Move to the directory ${KAOSHOME}.

  (3)	Type "kaos_install" 	and follow the instructions on the screen.

# NOTE:	The existence of the file "installcap" is important. Do not edit
	this file directly unless you are quite sure.
	In case you edit the installcap file, make sure that information
	in it is consistent with those in the files, Makefile, in various
	kaos directories and in the kaos header files in the
	directory ${KAOSHOME}/include.
	

##########################################################################
	COMPILING AND LOADING KAOS WITH MAKEFILE
###########################################################################

	If you have not defined ${KAOSHOME} in ".login" and ".cshrc", do so now.
	If you have not run "kaos_install", do so now.

  (1)	Note that a default directory for the user-customized kaos ("kaos_u") is
	set to ${HOME}/kaos in "Makefile" in the directory ${KAOSHOME}.
	If you want to install "kaos_u" in another directory, 
	edit the variable KAOS_USER_DIR below.

  (2)	To make all the executables kaos needs, type
	either "make all" if you are installing kaos from scratch
	or "make all_u" if kaos is already installed on the system and you
	want to make a local version of it with new dynamical systems.

	To make the main executable only, type
	either "make kaos",
	or "make kaos_u"

	To make a batch executable only, type
	either "make kaos_batch"
	or "make kaos_batch_u"
	(This is necessary to send batch jobs.)

	To make all the rest of executables in ${KAOSHOME}/bin,
	type "make bin"


#######################################################################
	INSTALLING A NEW DYNAMICAL SYSTEM
#######################################################################
	
	Look up README file in the directory ${KAOSHOME}/userlib

########################################################################
	ACCESSING THE SOURCE CODE PF BUILT-IN DYNAMICAL SYSTEMS IN DATABASE
########################################################################

	Lookup README file in ${KAOSHOME}/modellib directory for more
	information on how many vector fields and maps in our
	dynamical system database are defined.

########################################################################
	DESCRIPTION OF BUILT-IN DYNAMICAL SYSTEMS IN DATABASE
########################################################################

	Lookup the files ${KAOSHOME}/modellib/*.info

########################################################################
	CHANGING PARAMETERS OF DYNAMICAL SYSTEM CLASS
	BUILDING A NEW DYNAMICAL SYSTEM CLASS
########################################################################

	Lookup the file README ${KAOSHOME}/modellib


########################################################################
	PORTING TO OTHER DIRECTORIES AND MACHINES
########################################################################
To port kaos to other directories or other machines with the same 
architecture, one needs to make a copy of kaos source codes.

Use the command "kar" in $KAOSHOME/bin. 

To create a tar file
--------------------
(1) Type "kar"
(2) After the prompt "Enter a tar file name:", type the name of tar file.
(3) You will see a list of copy options. Depending on your needs, 
choose a proper option. (See the description on the screen for more info.)

To copy across the directories
------------------------------
Type "bin/kar -c" from $KAOSHOME.

Note that the size of kaos may be one's major concern becase of the
disc space constraint. Discard the groups of files you think are 
less important. Typically the order of  directories to go is:
	archive
	data
	contriblib
	companionlib
	PS
	RAS
	doc
	info
	examples
Depending on one's need, 
	auto
	graph
	batch
kaos still would compile without all the above directories.

Theinstallation will be even faster if
one does not have to recompile the source codes.

Global change of C flags
------------------------
To remove the C debugging flags and optimize the compilation,
type 
	kedgr "-g" "-O" Makefile

After kaos has been mobe, rerun kaos_install to change the kaos
home directory.

